home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / diary_note / journal / !Journal / !Help < prev    next >
Encoding:
Text File  |  1995-07-08  |  5.7 KB  |  145 lines
  1. This is !Journal, version 1.00  (28 June 1995)
  2.  
  3.  
  4. Intro
  5. =========
  6. This is a program designed to make keeping a regular diary easier. I wanted
  7. one to store regular comments about the nature reserve at which I am the
  8. honorary warden. Several diary programs exist, but they all seem to offer
  9. limited space, for a particular day.
  10.  
  11. I needed a text editor program, that conveniently sorted out the naming and
  12. storing of textfiles. I did not intend to reinvent the wheel, since Guttorm
  13. Vik and Dominic Symes already have,in writing the excellent !StrongED and
  14. !Zap applications, so I decided to make a front end type of diary using OLE
  15. to send all the text work to !Edit, !Zap or !StrongED.
  16.  
  17. Necessary resources 
  18. ====================
  19.  
  20. The user must have a copy of !Scrap available, and already 'seen ' by the
  21. system, along with a copy of !Edit, !Zap or !StrongED2.
  22.  
  23. I don't know why but the text editor must be loaded before !Journal.
  24.  
  25. Use  
  26. ====
  27.  
  28. An icon is installed on the icon bar, and clicking on this opens a small
  29. window, as usual. This contains the days date, and just one button, labelled
  30. Edit Entry. Clicking on this causes one of the three text editors to be
  31. opened, with a file, which starts with the day's date. An entry for the
  32. day's diary can be entered. If perchance you wanted to add a textfile from
  33. some other source, to the day's entry you are able to drag it to the window,
  34. in the usual RiscOS fashion. When you have finished, your entry, close the
  35. window, at which time, you will be asked if you want to save the file. Click
  36. on the SAVE option, and the file will be saved inside your !Journal
  37. application.
  38.  
  39. You will find that if you place your pointer over the date icon, and click,
  40. that the current months calendar comes up. Another date can be selected,
  41. and indeed other dates months and years can be accessed, from the 
  42. arrow type icons. If another date is selected, this calendar popup window
  43. disappears, and the selected date appears on the main window. Any editing
  44. now will concern the new selected date.
  45.  
  46. If you go back to a date for which an entry has already been made, it will
  47. return to the editing window, and can be edited.
  48.  
  49. Structure of files. 
  50. ====================
  51.  
  52. Inside the application directory, which can be looked at by double clicking
  53. on the icon in a filer window while <shift> is held down, you will find a
  54. subdirectory called 1995, and so on. If you click on this you will find a
  55. directory for each month. If you click on one of these months you will see a
  56. textfile for as many entries as there are, labelled with dates such as
  57. '23/Jun'.
  58.  
  59. If a directory for a year, that you have tried to do entries for, doesn't
  60. exist, you will get an error message, if you try to save a file. I have
  61. included directories for 1995 1996 & 1997. If you are still using this in
  62. 1998, or you want to do a retrospective diary, (I would be surprised), but
  63. you can easily, make a new directory by copying an empty year directory into
  64. the application window, renaming it to the year you want. Make sure it is
  65. empty first though.
  66.  
  67. It seems that if you use !Edit for your text editor, you will produce a word
  68. wrapped file automatically, but !Zap, or !StrongEd will need to be told to
  69. do this.
  70.  
  71. Saving 
  72. ======
  73. Entries are stored as soon as the window of the text editor is closed.
  74. However it may be that you wish to export a file to another program, or a
  75. printer. This can be done in the usual way from the menu of the main window.
  76.  
  77. Future 
  78. ====== 
  79. !Journal should include in the future:
  80.  
  81. An option to collate lots of entries into a continuous file.
  82.  
  83. Copyright 
  84. ========= 
  85. This program is  Public Domain. It may be distributed or
  86. copied freely as long as no part of this software is used in any other
  87. program, whether commercial or public domain,without my prior written
  88. consent, though any files created by this software are not bound by this
  89. condition. This software may not be distributed for a profit, save that
  90. required to cover packaging and media costs.. 
  91.  
  92. Copyright (©) is retained by the author, who may be contacted at the address
  93. beneath. No liability can be accepted by the author for any loss or damage
  94. arising from use or misuse of this software.
  95.  
  96. EventShell  
  97. ==========
  98.  
  99. Thanks to Paul Hobbs for his very useful !EventShell System.
  100.  
  101. This application uses the library of routines of the above name, which
  102. provide an easy way of genereating a Wimp Program. 
  103.  
  104. I recommend this system which can be obtained from APDL the DataFile
  105. or other PD  Libraries. 
  106.  
  107. This program has been written using the routines supplied with the EvntShell
  108. library which is copyright Paul Hobbs. The library routines may be
  109. distributed subject to the following conditions:
  110.  
  111. You have permission to use any part or the whole library in a project you
  112. intend to place in the public domain, as long as I am fully credited (via
  113. the inclusion of this file in the program documentation). If you wish to use
  114. these routines in a program that is for sale (for however much and for
  115. whatever reasons) or released as copyright material then my express
  116. permission in writing must be obtained. I maintain copyright on all the
  117. material supplied and reserve the right to amend these conditions in cases
  118. where I deem misuse. 
  119.  
  120. The library code is supplied free of charge to everyone 'as is'. There is no
  121. guarantee that it is free from bugs and no warranty is given about its
  122. suitability for use.
  123.  
  124. Further details about EvntShell may be obtained from the author:
  125.  
  126. Paul Hobbs 
  127. Rheinpfalzstrasse 2 
  128. 85049 
  129. Ingolstadt 
  130. Germany
  131.  
  132. The heap manager routines used by EvntShell are copyright Risc User and are
  133. used with permission.
  134.  
  135. -----------------------------------------------------------------------------
  136. Any improvements or bugs to !Journal, please report to :-
  137.  
  138. Robert Seago.
  139.  
  140. 40 Alton Park Road 
  141. Clacton On Sea
  142. Essex.
  143.  
  144. CO15 1ED
  145.